package com.chigga.application.config;

import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * Swagger 配置
 *
 * @author DefChigga
 */
@Configuration
public class SwaggerConfig {
    /**
     * admin 分组
     */
    @Bean
    public GroupedOpenApi adminApi() {
        return GroupedOpenApi.builder()
                .group("admin")
                .pathsToMatch("/admin/**")
                .build();
    }

    /**
     * 其它分组
     */
    @Bean
    public GroupedOpenApi otherApi() {
        return GroupedOpenApi.builder()
                .group("other")
                .pathsToMatch("/other/**")
                .build();
    }

    /**
     * common 分组
     */
    @Bean
    public GroupedOpenApi commonApi() {
        return GroupedOpenApi.builder()
                .group("common")
                // 包含所有路径
                .pathsToMatch("/**")
                // 排除 admin 和 other 分组
                .pathsToExclude("/admin/**", "/other/**")
                .build();
    }

    /**
     * 自定义 API 文档信息
     */
    @Bean
    public OpenAPI customOpenApi() {
        return new OpenAPI()
                .info(new Info()
                        // 标题
                        .title("Spring Boot 3 API")
                        // 版本
                        .version("1.0.0")
                        // 摘要
                        //.summary("摘要")
                        // 描述
                        .description("Spring Boot 3 应用程序的 API 文档")
                        // 联系信息
                        .contact(new Contact().name("DefChigga").email("defchigga@qq.com"))
                        // 协议
                        .license(new License()
                                .name("Apache 2.0")
                                .url("https://www.apache.org/licenses/LICENSE-2.0"))
                );

    }
}
